TDragTool_Contents
TDragTool	(C) Copyright 1996, Electronic Solutions.  All Rights Reserved.

TDragTool is a dragable tool bar that can be either docked in a parent window or floating around the screen in its own window.  The tool bar has all the same properties, methods and events as a TPanel plus the addition of the properties and events we added which are outlined in this document.  The TDragTool works by allowing the user to "Drag"  the tool bar anywhere within the parent if docked, or anywhere on the screen if windowed.

Properties	Methods	Events

We at Electronic Solutions are committed to bringing you only the finest in software products.   To do so we need your feedback on how we are doing.  This is a prerelease version of our Shareware version.  Feel free to try this component out and let us know what you think.  Electronic Solutions can be reached on the Internet at elecsol@primenet.com.  PLEASE READ this document as it contains valuable information on your rights for the use and distribution of this product.

There will be a 32bit version included in the released shareware version.

Pricing for TDragTool will be $39.95 for the 16/32bit component and $69.95 for the component and source code.

Since this is a prerelease version, there is a nag screen that shows up each time you run the application (once for each tool bar in the application).  In the Shareware version this will be replaced with a Nag screen only if Delphi is not running.

Electronic Solutions does not warrant this program to fit any particular need or situation.  This software is to be used "AS IS" and the user assumes all risks when using.  Electronic Solutions will not be held liable for any loss or damages that are either directly or indirectly associated with the use of this software.

This product may be freely distributed by any means seen fit as long as all the original files remain in tact and are accompanied together.

TDragTool CAN NOT be used as a base class for other components without the prior written consent from Electronic Solutions.  Other terms of the licensing agreement will be released with the shareware version.  There are no royalties or restrictions for the distribution of applications compiled with the TDragTool except those specifically stated in this document.

Any references to Delphi in this document acknowledges that Delphi is a trademark of Borland Inc.


TDragTool_AlignNote
The use of the Align property is not recommended since tool bars are not typically aligned with the client.


TDragTool_Parent
Parent is defined as the object in which the TDragTool was dropped onto or assigned to with TDragTool.Parent.  Typically the parent will be a TPanel.


TDragTool_Properties
AdjustParent

Align

AllowOverTop

SnapToGrid

SnapX

SnapY

Title

Version


TDragTool_Windowed
Windowed

You can use this method to set or read the windowed state of the tool bar.  When read, it will return TRUE if the tool bar is in its own window, and FALSE if its docked in the parent.  If you want to automatically put the tool bar in a window then you can call this method with True.

Example:

if MyToolBar.Windowed then

MessageDlg('The Tool Bar is in a Window', mtInformation, [mbOK],0);

{Place the tool bar in its own window}

MyToolBar.Windowed := True;


TDragTool_Methods
Windowed


TDragTool_Events
OnBarMoved

OnBarWindowed

OnBarDocked


TDragTool_AdjustParent
AdjustParent

This property determines whether or not the parent's height is adjusted to accommodate the tool bar.  If the parent is a TForm, then  it is recommended that this be set to FALSE.  If the parent is a TPanel, then it is recommended that it be set to TRUE.


TDragTool_AllowOverTop
AllowOverTop

This property determines whether or not the tool bar can sit on top of another tool bar.  If you want to allow the user to overlap tool bars then you should set this FALSE.  If you want the tool bars to adjust their position to the right of any tool bar its sitting on, set this to TRUE.  If this property is FALSE and the user attempts to drag the tool bar on top of another tool bar, then the position of the dragged tool bar is changed so that at least part of the tool bar shows up in the parent and that it is to the right of the tool bar it was dragged onto.


TDragTool_SnapToGrid
SnapToGrid

This property determines whether or not the tool bar is aligned on a grid or if it sits where the user drags it.  The values in SnapX and SnapY determine the behavior of the snapping.

See Also:

SnapX

SnapY


TDragTool_SnapX
SnapX

The value of SnapX determines the size of grid the tool bar is snapped to in the Horizontal direction (X).  This value is specified in pixels.  If the value is 0 or below then no snapping on the X axis is performed.

See Also:

SnapToGrid

SnapY


TDragTool_SnapY
SnapY

The value of SnapY determines the size of grid the tool bar is snapped to in the Vertical direction (Y).  This value is specified in pixels.  If the value is 0 or below then snapping on the Y axis is performed based on the height of the tool bar.

See Also:

SnapToGrid

SnapX


TDragTool_Title
Title

This is the title that appears on the window's title bar when the tool bar is dragged off the parent.  This allows you to assign a descriptive text to the tool bar such as "File Tool Bar".


TDragTool_Version
Version

Version is a read-only property that allows you to see what version of the TDragTool you are using.


TDragTool_OnBarMoved
OnBarMoved

This event gets called anytime the user moves the tool bar within the parent.  If the tool bar gets put in a window then this event is NOT called. The OnBarWindowed event is called instead.


TDragTool_OnBarWindowed
OnBarWindowed

This event gets called when the tool bar moves from its docked position to a floating position.


TDragTool_OnBarDocked
OnBarDocked

This event gets called when the tool bar window is closed and the tool bar has been returned to its docked position.